Xbasic

WAIT_UNTIL Function

Syntax

Result_Flag as L = WAIT_UNTIL(L event[,N every[,N timeout]])

Arguments

eventLogical

Logical. An Xbasic expression that resolves to either .T. (TRUE) or .F. (FALSE).

everyNumeric

Numeric. Optional. Default = .001 seconds. The interval in seconds between checks of Logical_Expression.

timeoutNumeric

Numeric. Optional. Default = forever. The number of seconds to wait before returning to the script, regardless of Logical_Expression.

Description

Wait for an event, Returns TRUE if event returned TRUE, options - event returns true -- 'every' is time between event checks in seconds, optional timeout is time to give up after in seconds.

Example

WAIT_UNTIL() causes a script to stop processing until Logical_Expression is .T. . Alpha Anywhere checks the Logical_Expression every Every_N_Seconds. When the Logical_Expression is .T., the script continues and sets Result_Flag to .T. . If, after the interval specified by Timeout_After, the Logical_Expression is still not TRUE, the script continues and sets Result_Flag to .F.. If Timeout_After is not specified, then Alpha Anywhere will wait indefinitely until the Logical_Expression is .T. .

Limitations

Desktop applications only.

See Also